Skip to main content

task voice - Voice Session Task

Command Title​

/task voice

Description​

This command allows you to set up a task that rewards users for being active in a voice channel. It's a great way to encourage server members to use voice chat and participate in conversations.

Usage​

/task voice <reward> <voice_time> <reward_mode> <channel> [duration] [daily_start_time] [daily_end_time] [reward_role] [daily_limit]

Parameters​

Required Parameters:​

  • <reward>: The number of points users will receive for completing the task.
  • <voice_time>: The required uninterrupted voice session time, in minutes.
  • <reward_mode>: The reward mode for the task.
    • once: Rewards are given only once upon completion.
    • every: Rewards are given for each voice session that meets the required voice_time.
  • <channel>: The voice channel where the task is active. You can select all voice channels or a specific one.

Optional Parameters:​

  • [duration]: The number of days the task will be active. Set to 0 for no time limit. The default is 0/Unlimited.
  • [daily_start_time]: The daily start time for the task to be active (in the server's timezone). The default is 00:00:00.
  • [daily_end_time]: The daily end time for the task to be active (in the server's timezone). The default is 23:59:59.
  • [reward_role]: The role that users will receive upon completing the task.
  • [daily_limit]: The maximum number of times a user can receive the reward per day. This parameter is only effective when [reward_mode] is set to every.

Examples​

  • Example 1: Set up a task that rewards users with 50 points for every 30 minutes of voice time in the General voice channel, with no daily limit or end date.

     /task voice reward:50 voice_time:30 reward_mode:every channel:General

  • Example 2: Set up a task that rewards users with the @Talkative role and 100 points for being in the Meeting Room channel for 60 minutes. The task will be active for 7 days, from 10:00 AM to 6:00 PM every day.

     /task voice reward:100 voice_time:60 reward_mode:once channel:Meeting Room duration:7 daily_start_time:10:00 daily_end_time:18:00 reward_role:@Talkative

  • Example 3: Set up a task in the Event Stage channel that rewards users with 20 points for every 15 minutes of voice time, with a daily reward limit of 3 times per user.

     /task voice reward:20 voice_time:15 reward_mode:every channel:Event Stage daily_limit:3

Notes​

  • Only one voice task can be active on the server at a time.
  • Voice time must be uninterrupted (i.e., not disconnecting and reconnecting).
  • The reward can be points and/or a role.
  • If a user is muted or deafened, their time in the voice channel might not count.

FAQs​

  • Q: Can I set up this task for all voice channels at once?

    A: Yes, you can choose "all voice channels" as the channel parameter to make the task active across all voice channels in your server.

  • Q: What happens if a user leaves the voice channel and rejoins later?

    A: The voice_time parameter tracks uninterrupted time. If a user leaves and rejoins, their timer will reset.

  • Q: When should I use once vs. every for the reward mode?

    A: Use once for a one-time achievement reward (e.g., a "Voice Starter" award). Use every to continuously reward active members (e.g., rewarding them for every 30 minutes they spend in voice chat).